
╔═════════╦════════════════════════════════════════════════════════════
║ GT-HELP ║ Colour Codes for SYSOP.BBS, GTMDIR.BBS and GTDIR.BBS files
╚═════════╩════════════════════════════════════════════════════════════


    These three .BBS files will support "embedded colour commands".

    Note that even if you don't *plan* on using colours in this file,
    you have to take care if your text in any of these files contains
    any of these special characters :

        %   $   &   [   ]   ~


┌──────────────────────────┐
│ Embedded Colour Commands │
└──────────────────────────┘

    Embedded colour commands allow a single file to control the display
    for both ANSI and non-ansi callers.  If the caller has selected the
    ANSI option, colour codes will be inserted.  If the caller has not
    selected ANSI, then the colour codes will be stripped out and ignored.

    Essentially, there are three possible colour schemes, represented
    by symbols.  The colours take their values from the GT.CNF file
    but, for the purposes of this example, let us assume you have set
    your colours to the "Mono-Compatible" colour set which GT-Help
    offers.

                     ╔════════════════════╤═══════════════════════╗
                     ║   Standard text    │     Highlit text      ║
    ╔════════════════╬════════════════════╪═══════════════════════╣
    ║   & (default)  ║  Option Lowlight   │   Option Highlight    ║
    ║                ║       (red)        │       (yellow)        ║
    ╟────────────────╫────────────────────┼───────────────────────╢
    ║       $        ║    Window text     │      Select Bar       ║
    ║                ║      (green)       │   (black on white)    ║
    ╟────────────────╫────────────────────┴───────────────────────╢
    ║   ~ (tilde)    ║     Callers own Terminal Mode Default      ║
    ║                ║           (no way of knowing)              ║
    ╚════════════════╩════════════════════════════════════════════╝


    a)  Colours revert to the default colour set at the beginning of each
        line.

        So, with the example colour scheme, text will normally be displayed
        in RED unless it is enclosed in square brackets, in which case the
        brackets are omitted and it will be displayed in YELLOW.

    b)  As an alternative, you can precede the line with a $ sign.

        In this case, text on that line will be displayed in GREEN unless
        enclosed in square brackets, making it BLACK ON WHITE.

    c)  You can precede a line with a ~, turning off colour attributes
        for that line.  In this case, the line will be displayed in an
        "unknown" colour that is dependent on what the CALLER has
        configured as the terminal mode default colour.



    For an easy way of understanding it, paste this text into your
    GTMDIR.BBS file and display it using ANSI :

            ----------------------------------------
            A default line with a [highlighted] word.
            $An alternative line with a [highlighted] word.
            A continuation line, showing [reversion] to default.
            $Alternative with [highlight] and &early [reversion].
            ~A line in Callers Terminal Mode colour.
            A continuation line, showing [reversion] to default.
            ----------------------------------------




    Special cases:

        If you need callers to *see* any of the special characters

                %   $   &   [   ]   ~

        you should precede them with % to prevent them from being
        interpreted as colour controls.

        If you need callers to see the % sign, you should use two of them,
        ie %%


